Permissions Overview

Have you ever felt confused or even overwhelmed when trying to set Nadeko's permissions? In this guide we will be explaining how to use the permission commands correctly and even cover a few common questions! Every command we discuss here can be found in the Commands List.

To see the old guide for versions 0.9 and below, see here

First Time Setup

To change permissions you must meet the following requirement:

Have the role specified by .permrole (By default, this is Nadeko)

If you have an existing role called Nadeko but can't assign it to yourself, create a new role called Nadeko and assign that to yourself.

If you would like to set a different role, such as Admins, to be the role required to edit permissions, do .permrole Admins (you must have the current permission role to be able to do this).

Basics & Hierarchy

The Commands List is a great resource which lists all the available commands, however we'll go over a few commands here.

Firstly, let's explain how the permissions system works - It's simple once you figure out how each command works! The permissions system works as a chain, everytime a command is used, the permissions chain is checked. Starting from the top of the chain, the command is compared to a rule, if it isn't either allowed or disallowed by that rule it proceeds to check the next rule all the way till it reaches the bottom rule, which allows all commands.

To view this permissions chain, do .listperms, with the top of the chain being rule number 1, shown at the top of the message.

If you want to remove a permission from the chain of permissions, do .removeperm X to remove rule number X and similarly, do .moveperm X Y to move rule number X to number Y (moving, not swapping!).

If you want the bot to notify users why they can't use a command or module, use .verbose true and Nadeko will tell you what rule is preventing the command.

Commonly Asked Questions

How do I create a music DJ?

To allow users to only see the current song and have a DJ role for queuing follow these steps:

  1. .sm Music disable

    • Disables music commands for everybody

  2. .sc !!nowplaying enable

    • Enables the "nowplaying" command for everyone

  3. .sc !!listqueue enable

    • Enables the "listqueue" command for everyone

  4. .rm Music enable DJ

    • Enables all music commands only for the DJ role

-- Thanks to @applemac for providing the template for this guide